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Introduction
------------

This document explains how to install and configure Intel(R) Threading
Building Blocks.  Installation is a multi-step process.  You should read
this document in its entirety before you begin.  Follow the steps
provided in sequence.

For information about product contents, including new and changed
features, please refer to the files Release_Notes.txt and README.txt.
You can view these files either before installation, or after
installation in the product "doc" sub-directory.


System Requirements
-------------------

See Release_Notes.txt for detailed hardware and software requirements.


Obtaining Intel(R) Threading Building Blocks
--------------------------------------------

To download the latest version of Intel(R) Threading Building Blocks,
please visit the Intel(R) Registration Center at:

	https://registrationcenter.intel.com/

See the Technical Support section of Release_Notes.txt for details.


Installing Intel(R) Threading Building Blocks
---------------------------------------------

The installation software installs the full set of Intel(R) Threading
Building Blocks files for your platform, for all supported operating
systems and processors.  These files and their install locations are
described in README.txt.

Previous versions of Intel(R) Threading Building Blocks can co-exist
with this version.  However, if you are installing an update on a system
that has *this version* installed, you need to uninstall the existing
version before installing this version.

See Release_Notes.txt for any known issues related to installation.

To install on Microsoft* Windows* systems:

    1.  Start the installation program.

	a.  If you received the product on CD-ROM, insert the CD-ROM
	    into a CD-ROM drive.  If the installation program does not
	    automatically start, locate the file Setup.exe on the CD-ROM
	    and double-click it.

	b.  If you received the product as an electronic download,
	    double-click the downloaded file, named
	    tbb10_<version#>_win.exe.

	The installation program starts.  Click "Next".

    2.  At the prompt, accept the default temporary directory or choose
	a different temporary directory into which the contents of the
	self-extracting installation file will be placed before actual
	installation begins.  Click "Next".

    3.  The Intel(R) Software Setup Assistant appears.  Click "Next" to
	continue the installation, or click the links provided on the
	left-hand side to view useful product and support information.

    4.  Choose between the following product license options:

	    (1) Use the existing license found on the system.
	    (2) Provide your serial number.
	    (3) Provide a license file.

	A recommended option is indicated, and options that are not
	applicable are not displayed.  You may have to click "More
	Options" to see some of these options.

	a.  Choose option (1) and click "Next" if an existing license is
	    already available on your system.

	b.  Choose option (2), enter a serial number, and click "Next"
	    if you are connected to the Internet and you have a serial
	    number.

	    A serial number was provided to you when you purchased the
	    product, either in an e-mail from Intel or your reseller, or
	    on a sticker attached to the CD-ROM package.  The correct
	    license, based on the serial number, will automatically be
	    downloaded and installed on your system.

	c.  Choose option (3), enter the path to a license file, and
	    click "Next" if you are not connected to the Internet or you
	    have a license file.

	    If installing from CD-ROM, a default license is installed
	    on the CD-ROM that permits installation and use of the
	    product but does not allow upgrades/updates.

	    If not installing from CD-ROM, a license was provided to
	    you, when you purchased the product, in an e-mail from Intel
	    or your reseller.  Copy the license to a location on your
	    system, choose option (3), provide the path to the license
	    file, and click "Next".

    5.  The installation begins.  Click "Next" to proceed.

    6.  Read the license agreement and click "Next" to accept it and
	continue.

    7.  Accept the default installation directory or choose a different
	directory.  In the directory you choose, a product/version
	directory is created where all product files are installed.  Any
	previous product version(s) can co-exist with this product
	version.  Make sure to update your build scripts to point
	to the desired product version if you choose to keep multiple
	versions installed.  Click "Next".

    8.  Select the checkbox to register the PATH, LIB and INCLUDE
	environment variables for the environment you wish to use, so
	that the product libraries and headers can be located easily
	when compiling and linking.  Click "Install" to proceed with the
	installation.

	After the installation completes, a file named tbbvars.bat is
	placed in each of the "bin" sub-directories where the product
	software is installed.  Use this file to set the PATH, LIB and
	INCLUDE environment variables in a user shell or to select a
	different environment after installing.

    9.  Wait for the installation to complete, and then click "Finish".

    10. If you have not already registered your product, a registration
	screen appears.  Enter your full e-mail address to register for
	Intel(R) Premier Support, free product updates, and more, or
	click "Cancel" to skip the registration step.

	If you have already registered your product, the Intel(R)
	Software Setup Assistant re-appears.  Click the links on the
	left-hand side, or click "Finish" when done.

To install on Linux* systems:

    In the following instructions, specific examples of commands for
    various steps are prefixed with '#' characters.

    1.  Unpack the package in a directory to which you have write
	access.

	    # cd <directory>
	    # tar -xzf tbb10_<version#>_lin.tar.gz

    2.  Run the installation script.  Execute the script in the
	directory where the package was unpacked in the previous step.

	    # cd <directory>/tbb10_<version#>_lin
	    # ./install.sh

    3.  If you are logged in as root, you may choose to install with or
	without using RPM, however, using RPM is strongly recommended.
	If you are not logged in as root, you may only install without
	using RPM.  Enter your selection as appropriate.

    4.  The Intel(R) Software Setup Assistant starts.  The installation
	script displays a series of options:

	    1.  Install
	    2.  Readme
	    3.  Release Notes
	    4.  Installation Guide
	    5.  Product Web Site URL
	    6.  Intel(R) Support Web Site URL

	Enter 1 to begin the installation, or enter another choice to
	view useful product and support information.

    5.  Choose between the following product license options:

	    1. Use existing license found on your system.
	    2. Proceed with Serial Number to install and register.
	    3. Provide a path to a license file.
	    x. Exit.

	A recommended option is indicated, and options that are not
	applicable are not displayed.

	a.  Enter 1 if an existing license is already available on your
	    system.

	b.  Enter 2 and enter a serial number if you are connected to
	    the Internet and you have a serial number.

	    A serial number was provided to you when you purchased the
	    product, either in an e-mail from Intel or your reseller, or
	    on a sticker attached to the CD-ROM package.  The correct
	    license, based on the serial number, will automatically be
	    downloaded and installed on your system.

	c.  Enter 3 and enter the path to a license file if you are not
	    connected to the Internet or you have a license file.

	    If installing from CD-ROM, a default license is installed
	    on the CD-ROM that permits installation and use of the
	    product but does not allow upgrades/updates.

	    If not installing from CD-ROM, a license was provided to
	    you, when you purchased the product, in an e-mail from Intel
	    or your reseller.  Copy the license to a location on your
	    system, choose option (3), provide the path to the license
	    file, and click "Next".

    6.  The installation script then extracts the product and does some
	prerequisite checking.

	Enter 1 to proceed with the installation, or enter x to exit
	without installing.

    7.  Press <enter> to display the license agreement.  Read the
	license agreement and enter accept to continue.

    8.  The installation will continue after accepting the license
	agreement.

	Enter the path to use for temporary files or press <enter> to
	accept the default temporary file path.

	Next, enter the desired install path or press <enter> to accept
	the default install path.  In the directory you choose, a
	product/version directory is created where all the product files
	are installed.  Any previous product version(s) can remain
	installed when installing this product version.  Make sure to
	update your build scripts to point to the desired product
	version if you choose to keep multiple versions installed.

	In each case, if you are not logged in as root, you will need to
	choose directories for which you have write access.

    9.  Wait for the installation to complete.

	After the installation completes:

	- The "bin" and "lib" sub-directories are created that link to
	    the architecture/platform-specific "bin" and "lib"
	    sub-directories for the architecture and platform on which
	    the product software was installed.

	- Files named tbbvars.sh and tbbvars.csh are placed in the
	    "bin" sub-directories.  Use these files to set the
	    LIBRARY_PATH, LD_LIBRARY_PATH and CPATH environment
	    variables in a user shell so that the product libraries and
	    headers can be located when compiling and linking.

    10. If you have not already registered your product, a registration
	screen appears.  Enter your full e-mail address to register for
	Intel(R) Premier Support, free product updates, and more, or
	enter x to skip the registration step and exit the installation
	script.

	If you have already registered your product, the Intel(R)
	Software Setup Assistant re-appears.  Enter x to exit the
	installation script, or enter another choice to view useful
	product and support information.

To install on Mac OS* systems:

    Note that Mac OS X* Xcode* Tools 2.2.1 or higher must be installed
    prior to installing Intel(R) Threading Building Blocks on Mac OS*
    systems (see also Release_Notes.txt).

    1.  Start the installation program.

	a.  If you received the product on CD-ROM, insert the CD-ROM
	    into a CD-ROM drive.   Locate the file
	    tbb10_<version#>_mac.dmg on the CD-ROM and double-
	    click it.

	b.  If you received the product as an electronic download,
	    double-click the downloaded file, named
	    tbb10_<version#>_mac.dmg.

    2.  Open the mounted disk to view the contents.  Locate the file
	named Install, and double-click it.

    3.  The Intel(R) Software Setup Assistant appears.  Click "Continue"
	to continue the installation, or click the links provided on
	the left-hand side to view useful product and support
	information.

    4.  Choose between the following product license options:

	    (1) Use the existing license found on the system.
	    (2) Provide your serial number.
	    (3) Provide a license file.

	A recommended option is indicated, and options that are not
	applicable are not displayed.  You may have to click "More
	Options" to see some of these options.

	a.  Choose option (1) and click "Next" if an existing license is
	    already available on your system.

	b.  Choose option (2), enter a serial number, and click "Next"
	    if you are connected to the Internet and you have a serial
	    number.

	    A serial number was provided to you when you purchased the
	    product, either in an e-mail from Intel or your reseller, or
	    on a sticker attached to the CD-ROM package.  The correct
	    license, based on the serial number, will automatically be
	    downloaded and installed on your system.

	c.  Choose option (3), enter the path to a license file, and
	    click "Next" if you are not connected to the Internet or you
	    have a license file.

	    If installing from CD-ROM, a default license is installed
	    on the CD-ROM that permits installation and use of the
	    product but does not allow upgrades/updates.

	    If not installing from CD-ROM, a license was provided to
	    you, when you purchased the product, in an e-mail from Intel
	    or your reseller.  Copy the license to a location on your
	    system, choose option (3), provide the path to the license
	    file, and click "Next".

    5.  The installation program starts.  Click "Continue".

    6.  Read the Introduction information and click "Continue".

    7.  Read the license agreement and click "Continue" and "Accept".

    8.  Note the Volume where the destination folder for your
	installation will be located and click "Continue".

    9.  Click "Install" (or "Upgrade") to begin the installation.

    10. Wait for the installation to complete, and then click "Close".

	After the installation completes:

	- The "bin" and "lib" sub-directories are created that link to
	    the architecture/platform-specific "bin" and "lib"
	    sub-directories for the architecture and platform on which
	    the product software was installed.

	- Files named tbbvars.sh and tbbvars.csh are placed in the
	    "bin" sub-directories.  Use these files to set the
	    LIBRARY_PATH, LD_LIBRARY_PATH and CPATH environment
	    variables in a user shell so that the product libraries and
	    headers can be located when compiling and linking.

    11. If you have not already registered your product, a registration
	screen appears.  Enter your full e-mail address and click
	"Continue" to register for Intel(R) Premier Support, free
	product updates, and more, or close the window to skip the
	registration step.

	If you have already registered your product, the Intel(R)
	Software Setup Assistant re-appears.  Click the links on the
	left-hand side, or click "Finish" and "Yes" when done.


Uninstalling Intel(R) Threading Building Blocks
-----------------------------------------------

Note: Uninstalling the product software does *not* delete the
corresponding license file.

Microsoft* Windows* Systems

    1.  Click the Windows "Start" button and select "Settings",
	"Control Panel", "Add or Remove Programs".

    2.  Click Intel(R) Threading Building Blocks to select it from
	the list of installed software.

    3.  Click "Remove" and then click "Yes" to uninstall.

Linux* Systems

    In the following instructions, specific examples of commands for
    various steps are prefixed with '#' characters.

    1.  Run the uninstallation script.  Execute the script in the
	directory where the package was installed.

	    # cd <installation directory>
	    # ./uninstall.sh

Mac OS* Systems

    In the following instructions, specific examples of commands for
    various steps are prefixed with '#' characters.

    1.  Run the uninstallation script.  Execute the script in the
	directory where the package was installed.

	    # cd <installation directory>
	    # ./uninstall.sh

    2.  An alternative to using uninstall.sh is to double-click the
	"uninstall" icon that is located in the installation directory.
	This icon has the file name uninstall.app.


Technical Support
-----------------

For detailed technical support information for Intel(R) Threading
Building Blocks, see Release_Notes.txt.
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